home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM BV3 / BMUG PD-ROM Version BV3 (CDRM1097900).iso / Telecom / Compacting Programs / StuffIt Expander™ / Read Me next >
Text File  |  1993-06-14  |  14KB  |  156 lines

  1. StuffIt Expander™
  2. Written by Leonard Rosenthol
  3. Copyright ©1992-1993, Aladdin Systems, Inc. & Raymond Lau
  4.  
  5.  
  6. Installation:
  7. If you are reading this, you've already installed it!   However, for users of previous versions of StuffIt Expander, we recommend that you rebuild your desktop (hold down the command & option keys during startup) since this version has some new information in it.
  8.  
  9. Description:
  10. StuffIt Expander is designed to be the simplest, most efficient way to decompress any compressed Macintosh file you may have downloaded from an online information service or bulletin board system. There are thousands of such files available, and they are usually stored in one of several compressed archive formats. 
  11.  
  12. StuffIt Expander extracts files from the three most popular archive-based compression formats found on the Macintosh: StuffIt archives, Compact Pro™ archives and AppleLink™ packages.  All non-encrypted archives created by any versions of these products are supported, including files created with the commercial StuffIt Deluxe 3.0 and the shareware StuffIt Lite 3.0. 
  13.  
  14. StuffIt Expander will also decode files which have been encoded by BinHex 4.0 (or a compatible product), such as those commonly found on the Internet.   There is no need to strip out any headers from BinHex files before converting, StuffIt Expander will ignore anything that is not valid.  Multipart BinHex files, such as those appearing in Internet newsgroup postings (eg. comp.binaries.mac) are also supported.  
  15.  
  16. StuffIt Expander requires System 6.0.4 or later, and System 7 users additionally can enjoy an easy “drag and drop” interface.  You can also configure StuffIt Expander to perform periodic checks on the contents of a specified folder (called a "Watch Folder"), and to expand any newly added files that it finds.
  17.  
  18. StuffIt Expander is 32-bit clean, ‘040 cache and virtual memory compatible, Apple event aware and has an intelligent background processing scheme that makes it perfect for expanding groups of files while others are being downloaded. 
  19.  
  20. Using StuffIt Expander:
  21. System 7 users can have their archives expanded by dragging those icons onto the StuffIt Expander icon.  You may also drag a folder or disk icon over StuffIt Expander, and it will expand the contents of the folder or disk.
  22. 1. Select the icons of the files to be expanded.
  23. 2. Drag them over the StuffIt Expander icon until it highlights.
  24. 3. Let go of the mouse/trackball button.
  25. StuffIt Expander will open and you'll see a progress dialog showing how the expansion is going. Each archive gets expanded into a new folder, located in the same folder as the archive. If an archive contains a single file, then that file will not be put into a new folder. 
  26. When everything is expanded, StuffIt Expander automatically quits. 
  27.  
  28. System 6 users, or those who prefer a direct way to expand their files, should:
  29. 1. Double click on the StuffIt Expander icon.
  30. 2. Choose the “Expand…” command from the File menu.
  31. 3. Select the file to be expanded.
  32. 4. Click the “Expand” button.
  33. A progress dialog will appear, showing you how the expansion is going. Each archive gets expanded into a new folder, located in the same folder as the archive. If an archive contains a single file, then that file will not be put into a new folder.
  34. 5. Return to step 2 to expand more files or choose “Quit” from the File menu to exit StuffIt Expander.
  35.  
  36. Users who wish to set up a "Watch Folder":
  37. 1. Double click on the StuffIt Expander icon.
  38. 2. Choose “Preferences…” from the File menu.
  39. 3. Check the “Use Watch Folders” checkbox to enable the feature.
  40. 4. Now click the first “Select…” button and select the folder you want watched.
  41. 5. If you want the newly expanded contents from your watch folder to appear in a different folder (the destination), click the second “Select…” button and select a folder for the expanded files.
  42. 6. Type the number of minutes you want StuffIt Expander to wait between scans.
  43. 7. Click “OK”
  44. 8. Leave StuffIt Expander running, and do other things (such as downloading new files).
  45.  
  46. Special Features:
  47. * If you hold down the Shift key when dropping files on the icon, or when choosing Expand from the menu, StuffIt Expander will give you the opportunity to choose an alternate destination (i.e. another folder or disk) for the expanded items.
  48. * If you hold down the Option key when dropping the files on the icon, or when choosing Expand from the menu, StuffIt Expander will delete the original archives after expanding them.  You are not warned, so use this feature carefully.
  49. * If you hold down the Command key when launching the application, the "Check Watch Folder and then Quit" option will be temporarily overridden.  This is useful since otherwise you would not be able to change your preferences again.
  50. * If you hold down the Command key when choosing "Expand..." from the File menu, you will be able to select a folder (or entire disk) to expand, instead of a single file.
  51. * StuffIt Expander is able to handle multipart BinHex files, provided that all the parts are coordinated in order into a single file and all intermediate headers are removed. 
  52. * Scripters can control StuffIt Expander from other applications.  For example, with HyperCard use the “open <document> using "StuffIt Expander"” command.  With Frontier, use a “required.OpenDocument('SITx', document)”.   
  53. * Users of AppleScript and Frontier can get more sophisticated control over StuffIt Expander via the new "Expand" event.  Use the AppleScript Script Editor's "Open Dictionary" command to view the information on the Expand event.
  54.  
  55. Caveats:
  56. * With the exception of StuffIt 3.0 archives, StuffIt Expander will not expand encrypted or password protected archives.  
  57. * StuffIt Expander will not expand any segmented archives, nor will it expand StuffIt archives created using Optimizers.
  58. * In both of the above cases, if you do attempt to expand such an archive, StuffIt Expander will alert you and then continue on with any other archives you may have selected for expansion.
  59.  
  60. Troubleshooting:
  61. We hope that you won't have any problems with StuffIt Expander, but if you do you can contact Aladdin Systems using any of the following means:
  62. Aladdin Systems, Inc.
  63. 165 Westridge Drive
  64. Watsonville, CA 95076 USA
  65. Voice 408-761-6200; Fax 408-761-6206 
  66. AppleLink: Aladdin
  67. America Online: Aladdin
  68. Compuserve: 75300,1666
  69. GEnie: AladdinSys
  70. Internet: aladdin@well.sf.ca.us
  71.  
  72. Version History
  73. 1.0    - First public release (03/12/92)
  74. 1.0.1 - Update to fix some bugs and add some new features (06/01/92)
  75.                 * Creation & modification dates on files and folders in Compact Pro 
  76.                                    archives are now restored (even Compact Pro doesn't restore folder dates!)
  77.                 * Folders with custom icons in Compact Pro archives are properly restored
  78.                                 * Problems with "drag & drop" not working have been fixed
  79.                                 * Includes 'aete' resource for compatibility with Apple event scripting systems
  80.                                 * Improved performance & user response in both background & foreground
  81.                                 * Correctly handles expanding files on locked volumes
  82.                                 * Problems with handling large Compact Pro archive comments have been fixed
  83.                                 * and a couple of little tweaks.
  84. 3.0   - Major Update (11/15/92)
  85.                 * Added support for expanding Self-Extracting Archives
  86.                 * Added support for expansion of entire folders & disks
  87.                 * Added support for decoding BinHex files, including multi-part ones
  88.                 * Added support for "Watch Folders"
  89.                 * Problems with expanding complex Compact Pro archives have been fixed
  90.                 * Files expanded from StuffIt archives no longer lose their icons.
  91.                 * Expansion of Compact Pro archives is now faster
  92. 3.0.1  - Update to fix some bugs (12/18/92)
  93.                 * Improved usability of Watch Folders
  94.                 * Improved the decoding of BinHex files
  95.                 * Icons of expanded files are now always correct
  96.                 * Added support for folder expansion for System 6 users
  97.                 * Now includes a prettier about box!
  98. 3.0.2  - Update to fix some bugs & improve speed (6/14/92)
  99.                 * Expansion of all file types is now 5-15% faster!!
  100.                 * Added new "Expand" Apple event for more flexibility for scripters
  101.                 * Watch Folders now work correctly across multiple disks
  102.                 * BinHex expansion has been made more robust & will better handle headers
  103.                 * When selecting a folder, you can now create a new folder from the dialog
  104.  
  105.  
  106. Legal Stuff:
  107. Although copyrighted, this software is being licensed to you for your use free of charge.  However, ownership of and interest in this software shall remain with the author.  Use and distribution of this software is governed by the following terms in an effort to reasonably ensure that this software will remain freely available and that no one other than the author will derive a commercial benefit from distributing this software.
  108.  
  109. LICENSE AGREEMENT
  110. “You,” “your,” and the “user” refers to any person or entity which acquires or uses this software.
  111.  
  112. “Software” refers to any computer programs identified at the start of this documentation file, together with all codes, techniques, software tools, formats, designs, concepts, methods, ideas, and documentation associated with the computer program(s).  The term also includes all copies of any part of the software and documentation.
  113.  
  114. “Author” refers to the author of this software,  Aladdin Systems, Inc.
  115.  
  116. This software is owned by the author and contains valuable and proprietary information of the author. If you violate any part of this agreement, your right to use this software terminates automatically.  In the event of termination of this agreement, you must destroy all copies of this software and derivatives of this software in your possession and cease distributing the same.
  117.  
  118. This software is being licensed to you as provided by the terms of this agreement.
  119.  
  120. You may:
  121. 1. Use this software on as many computers as you want at any given time.
  122. 2. Make as many backup copies of this software as you want.
  123. 3. Alter the software in any manner you see fit FOR YOUR OWN PERSONAL USE.  Such altered versions should not be distributed.  The creation of such derivatives shall not diminish the author's title to this software.
  124. 4. Terminate this agreement at any time by destroying all copies of this software and derivatives of this software and cease distributing the same.
  125.  
  126. You may not:
  127. 1. Create any derivative works from this software for distribution.
  128. 2. Reverse engineer, disassemble, decompile, or otherwise attempt to discover the logic or source code to this software.
  129.  
  130. StuffIt Expander™ may be distributed for non-commercial purposes. 
  131.  
  132. It may also be freely distributed via wire or electronic communications (BBS's and online information systems) for the sole purpose of use by their customers.
  133.  
  134. Contact Aladdin Systems, Inc. at the address within this document if you wish to distribute this software in a compilation or for commercial usage, or if you have any questions about its redistribution.  
  135.  
  136. Disclaimer of warranty:
  137. In using this software, you understand and agree that this software is provided “as is” without warranty of any kind.  The entire risk as to the results and performance of using this software lies entirely with you, the user.  The author does not make any warranties, either expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software.
  138.  
  139. In no event shall the author be liable for any consequential, incidental, or special damages whatsoever (including without limitation damages for loss of critical data, loss of profits, interruption of business, and the like) arising out of the use or inability to use this software.  Because some states do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitations may not apply to you.
  140.  
  141. Although the author would appreciate any feedback and bug reports, the author shall not be responsible for correcting any problems which you discover or otherwise help you maintain and use this software.  Furthermore, the author may at any time replace, modify, alter, improve, enhance or change this software.
  142.  
  143. Complete agreement:
  144. This agreement constitutes the entire agreement and supersedes any prior agreements between you and the author concerning this software.  This agreement cannot be amended, modified, or waived except in writing.
  145.  
  146. General:
  147. If any provision of this agreement shall be found to be unenforceable, it shall be deemed severed from the remainder of this agreement.
  148.  
  149. This agreement shall be construed in accordance with the laws of the State of California.  Any arbitration or litigation relating to this agreement shall take place in the State of California. The parties further submit to waive any objections to personal jurisdiction of and venue in any of the following forums: U.S. District Court for the Northern District of California, California Superior Court for Santa Cruz County, Santa Cruz County Municipal Court or any other forum in Santa Cruz County, for any litigation arising out of this agreement.
  150.  
  151. U.S. GOVERNMENT RESTRICTED RIGHTS
  152. This Software is provided with RESTRICTED RIGHTS.  Use, duplication, or disclosure by the government is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 48 CFR 252.227-7013, or in subparagraphs (a) through (d) of the Commercial Computer Software Restricted Rights clause at 48 CFR 52.227-19, as applicable.  The contractor/manufacturer is Aladdin Systems, Inc. 165 Westridge Drive. Watsonville, CA  95076.
  153.  
  154.  
  155. All trademarks are held by their respective owners.
  156.